3D RSX  Contents  Interfaces  Data Structures  Previous  Next

Installing and Configuring 3D RSX

The topics presented here describe the contents of the 3D RSX Software Developer's Kit, the system requirements, the supported operating systems, and the licensing requirements. They also provide notes about the installation and describe how to set up, configure, and test the 3D RSX system.

The topics discussed here are:


Deliverables

The 3D RSX Software Developer's Kit Release package contains:


System Requirements

3D RSX requires an Intel486™ processor, 8 Megabytes RAM, a sound card, and Windows 95 or Windows NT operating system. For optimal performance, we recommend using a 90Mhz Pentium® processor with 16 Megabytes RAM.

Required

Processor - 80486 processor

Memory - 8 Megabytes

Disk Space - 5 Megabytes

Sound Card - Any

Recommended

Processor - 90Mhz Pentium® processor

Memory - 16 Megabytes

Disk Space - 25 Megabytes

Sound Card - Stereo Sound Card

Supported Operating Systems

3D RSX supports the following operating systems:


License Definitions

The 3D RSX Software Developer's Kit license (located on the CD-ROM) applies to all of the developer tools, sample source, documentation, and licensed binaries delivered with your 3D RSX Software Developer's Kit Release package. Please read the license agreement carefully before you use this product.

If you would like to ship 3D RSX with your application, contact Intel for a commercial, redistribution license. See Redistributing RSX for details and a description of how to include 3D RSX with your application.


Software

This SDK contains the Intel 3D RSX. The 3D RSX installation copies these files onto your hard disk:

Directory/File and Description

RSX3D\readme.wri
A file that you should read before using 3D RSX. It contains useful information about 3D RSX.
 
RSX3D\license.txt
A copy of the 3D RSX license agreement.
 
RSX3D\BIN\aaudio.dll
A DLL that maps RSX 1.0 calls to 3D RSX calls.
 
RSX3D\BIN\rsx.dll
The 3D RSX audio library.
 
RSX3D\BIN\rsxdata.dll
The 3D RSX audio data library.
 
RSX3D\BIN\rsxconfg.exe
A configuration/diagnostic utility to test if 3D RSX is working.
 
RSX3D\BIN\rsxconfg.hlp
The help file for rsxconfg.exe.
 
RSX3D\BIN\rsxtool.exe
A tray applet Tray applet that allows for easy switching between audio peripherals like headphones and speakers. This applet is executed when the 3D RSX libraries are active.
 
RSX3D\BIN\rsxtool.hlp
The help file for rsxtool.exe.
 
RSX3D\BIN\DEBUG\aaudio.dll
A debug version of aaudio.dll.
 
RSX3D\BIN\DEBUG\rsx.dll
A debug version of rsx.dll.
 
RSX3D\CEXAMPLE\
The source files for the minimal C example using 3D RSX.
 
RSX3D\CEXAMPLE\RELEASE\cexample.exe
A release version of the C example.
 
RSX3D\CEXAMPLE\RELEASE\cexample.wav
The wave file used by the C example.
 
RSX3D\CPPMIN\
The source files for the minimal C++/MFC example using 3D RSX.
 
RSX3D\CPPMIN\RELEASE\cppmin.exe
A release version of the C++/MFC example.
 
RSX3D\CPPMIN\RELEASE\cppmin.wav
The wave file used by the C++/MFC example.
 
RSX3D\DOCS\
The 3D RSX Documents in HTML format.
 
RSX3D\INCLUDE\rsx.h
The required header file for all 3D RSX-based applications.
 
RSX3D\INCLUDE\version.rc
A version resource template required to build the sample applications.
  
RSX3D\STREAMEM
Streaming Emitter Sample
 
RSX3D\SLSAMPLE
Streaming Listener Sample
 
RSX3D\RTSETUP
Install/Uninstall programs
 
RSX3D\SAMSAMPLE
Sample Setup for use with InstallShield
 
RSX3D\RSXPLAY\
The source files for the 3D RSX Audio Player.
 
RSX3D\RSXPLAY\RES
The resource source files for the 3D RSX Audio Player.
 
RSX3D\RSXPLAY\RELEASE\rsxplay.exe
A release version of the 3D RSX Audio Player.
 
RSX3D\RSXPLAY\RELEASE\rsxplay.wav
The wave file used by the 3D RSX Audio Player.

IMPORTANT: Windows NT does not currently support Direct3D, which is required for the following applications.

RSX3D\CHOPPER\
The source files and the executable for the 3D RSX Chopper Sample/Demo.
 
RSX3D\CHOPPER\RES
The resource source files for the 3D RSX Chopper Sample/Demo.
 
RSX3D\CLOWN\
The executable files for the 3D RSX Clown Demo.
 
RSX3D\RSXROIDS\
The source files and the executable for the 3D RSX Asteroids Sample/Demo.
 
RSX3D\RSXROIDS\RES
The resource source files for the 3D RSX Asteroids Sample/Demo.

NOTE. The samples and demos were built and tested using Microsoft Visual C++ 4.1.


3D RSX Web Page

Check Intel's Web page: http://www.intel.com/ial/rsx for updated information and releases.


Installation Notes

To install 3D RSX, simply insert the disc in your CD-ROM drive and follow the on-screen prompts to complete the installation. Although you may choose any name for your installation directory, the documentation refers to your top-level installation directory as RSX3D.


General Setup and Configuration

3D RSX provides a Diagnostic utility to determine whether 3D RSX is functioning properly. When you complete an 3D RSX installation, this utility runs and verifies the installation. To access this utility at other times, either open the Intel 3D RSX folder on your Start menu and click Configuration, or locate and run Rsxconfg.exe, which the installation copies into your 3D RSX\BIN directory.

The Configuration utility provides these property pages:

 

Testing Audio Peripherals

When you invoke the Configuration Utility, the Audio Peripherals property page opens. To access this property page at other times, click the Audio Peripherals tab. This property page lets you select an audio peripheral to use with 3D RSX, test your 3D RSX Audio, adjust sound balance and volume, and access the Intel Realistic 3D Sound Experience Web page.

To select an audio peripheral, click the radio button next to the appropriate statement or press a shortcut key sequence (<Alt> plus <S>, <H> or <D>). You can listen to 3D RSX output from speakers, or headphones.

To start the 3D RSX audio test, click Test 3D RSX Audio or press <Alt><T>. 3D RSX runs several diagnostic tests (some tests require that you respond to questions) and reports the results in a pop-up message box. Figure 1 shows the options on the Audio Peripherals property page. If the 3D RSX audio tests are not successful, run the Diagnostics to find out why the 3D RSX audio tests failed.

Figure 1. Testing Audio Peripherals

To adjust the sound level, click Adjust Volume or press <Alt><A>. This opens the Microsoft Volume Control applet. (You can also access this applet by double-clicking the speaker icon on the task tray.) This applet lets you adjust slide bars to set sound balance and volume for Volume Control, MIDI, Audio CD, Line-In, and Wave-Out audio devices.

To access the Intel RSX Web page, click Go. If you have a Web browser installed, you will jump directly to our Web page. There, you will find useful information, demonstrations, utilities, installation notes, and more.

Getting Diagnostics About Your RSX Installation

Click the Diagnostics tab to bring the Diagnostics property page to the foreground. This property page lets you run tests that check the status and setup of your computer and 3D RSX Audio. Click Run Diagnostics or press <Alt><R> to start the test. The utility initializes 3D RSX, creates a direct listener and a cached emitter, asks you some questions, and reports the results of its tests in the diagnostic scroll box. Figure 2 shows the output from a diagnostic test.

Figure 2. Testing the RSX Installation

Use the arrows on the scroll bar to scroll through the entire list of diagnostic messages. To save the output messages, click Copy Output to Clipboard. You can then paste the output into a mail message or another application. You might want to do this if you encounter a problem and want to send the messages to Technical Support (e-mail: rsx@intel.com) or post a question to the RSX newsgroup (news://cs.intel.com/Intel.rsx) or (http://cs.intel.com/Intel/rsx/).

Changing Advanced Settings

There are two Advanced Settings property pages: one to use to change buffer times and another to change device settings. See Figure 3 and Figure 4. You can also change these settings from the Registry.

Buffer Times

Click the Advanced Settings - Buffer Times tab to access the property page that lets you change the size and cache time used for the audio buffers your sound device uses when communicating with 3D RSX.

Buffering for output audio device represents the length of the output buffer in units of time. Valid buffer sizes are 20 to 400 seconds. If you experience audio glitches while playing audio files, increase the buffer size. If you notice that the movement of sound is slow, try decreasing the buffer size. To reset to the default buffer size (120 seconds), click Restore Default or press <Alt><R>.

The default cached emitter cache time is represents the amount of data from file-based emitters that is pre-loaded into memory. If the cached emitter resides on a slow CD-ROM or network drive and audio breaks up, increasing the cache time value may help. Valid cache times are greater or equal to one second. To reset to the default cache time (3 seconds), click Restore Default or press <Alt><D>.

Figure 3. Advanced Settings - Buffer Times Property Page

Device Settings

Click the Advanced Settings - Device Settings tab to access the property page that lets you change the default audio device format used by a direct listener and select a MIDI device. You can also change these settings from the Registry.

The Default Format of Audio Device list contains a range of settings from the lowest quality, 8 kilohertz, 8 bit monaural, to the highest quality, 44 kilohertz, 16 bit stereo. Select a format from the list. The default is a mid-range setting of 22 kilohertz, 16 bit stereo. To reset the audio device format to the default, click Restore Default or press <Alt><R>.

The MIDI Device Selection list contains a selection of available devices. Select the device you want to use for your application from this list. Click Test or press <Alt><T> to verify that 3D RSX can play MIDI through the selected device. If the MIDI doesn't play try a different MIDI device. The default and selections available are system dependent. To reset the MIDI device to the default, click Restore Default or press <Alt><D>.

The Enable 3D RSX Tray Icon Applet for quick selection of peripherals check box allows you to turn on or off the 3D RSX Tray Icon which appears in the Windows 95 tray while 3D RSX audio is playing. Click the check box or press <Alt><E> to toggle the icon.

Figure 4. Advanced Settings - Device Settings Property Page

Finding Out About 3D RSX

Click the About 3D RSX tab to display copyright information, instructions on how to get in touch with Intel, and a scrolling screen with information about 3D RSX. See Figure 5.

Figure 5. About RSX Property Page


3D RSX  Contents  Interfaces  Data Structures  Previous  Next

Copyright ©1996, 1997 Intel Corporation. All rights reserved